---
title: Atualização para v5
description: Como atualizar o seu projeto de Ultracite v4 para v5.
---

Ultracite v5 é uma versão principal com melhorias significativas e alterações incompatíveis. Este guia irá ajudá-lo a atualizar a sua configuração existente v4 para v5.

## Novidades no v5

- **Biome atualizado**: Atualizado de v1.x para v2.x
- **Novo formato de configuração**: Mudar de `biome.json` para `biome.jsonc`
- **CLI aprimorado**: Reescrito em TypeScript com melhor tratamento de erros
- **Integrações de editor**: Suporte integrado para Cursor, Windsurf, Zed e GitHub Copilot
- **Ganchos do Git**: Integrações opcionais incluindo Husky, lint-staged e lefthook
- **Esquema aprimorado**: Novo URL do esquema com validação melhorada
- **Configurações do VS Code simplificadas**: Combinação das substituições de tipo de arquivo em uma única linha

## Etapas de migração

### Migração automática (Recomendada)

A maneira mais fácil de migrar é executar o novo comando de inicialização:

```package-install
npx ultracite@latest init
```

Isto fará:
- Atualizará suas dependências para as versões mais recentes
- Atualizará seu `biome.json` ou `biome.jsonc`  
- Atualizará suas configurações do VS Code
- Oferecerá configurar regras de editor com IA (Cursor, Windsurf, Zed, etc.)
- Oferecerá configurar novas integrações (ganchos do Git, lint-staged, etc.)

Após a atualização, você pode querer revisar seu arquivo `biome.json` / `biome.jsonc` para remover quaisquer substituições. Além disso, reinicie o seu editor para garantir que a nova configuração seja aplicada.

Além disso, consulte o Biome [guia de atualização para o Biome v2](https://biomejs.dev/guides/upgrade-to-biome-v2/) para mais informações sobre alterações de esquema/regras.

### Migração Manual

Se preferir ter mais controle sobre o processo, siga os passos de [Migração Manual](/setup#manual-installation) fazendo:

- Instalando manualmente as versões atualizadas do Ultracite e do Biome
- Atualizando seu arquivo `biome.json` para a nova versão do esquema
- Atualizando o arquivo `.vscode/settings.json` (opcional)
- Adicionando um arquivo de regras de editor com IA (opcional)
- Adicionando novas integrações (opcional)

Após a migração, reinicie seu editor para garantir que a nova configuração seja aplicada.